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PREFACE 


This  product  specif icat ion  oovers  the  work  performed  under 
Air  Foroe  Contract  F33615-80-C-5155  ( I CAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Foroe 
Systems  Command ,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  I CAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Scheneotady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany.  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  $201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer . 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search . 

Responsible  for  factory  view 
function  and  information 
models . 
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Subcontractors 

Illinois  Institute  of 
Technology 

North  Anerioan  Rockwell 
Northrop  Corporation 

Pri taker  and  Associates 
SofTeoh 


Role 

Responsible  for  factory  view 
function  researoh  (IITRI) 
and  information  nodels  of 
snail  and  nediun-sise  business. 

Reviewer. 

Responsible  for  factory  view 
funotion  and  information 
nodels. 

Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


Role 


TASKS  4.3  -  4.9  (TRST  BID) 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

Computer  Technology 
Associates  (CTA) 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 


Control  Data  Corporation 
(CDC) 


Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DA00M) . 


D.  Appleton  Company 
(DAOOM) 


Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DAOOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


iv 
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Subcontractors 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Autonation  Company 
(MoAuto) 


On-Line  Software 
International  (OSI) 


Role 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operat i on . 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  &  Dodge) 


Sof Teoh ,  Inc . 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 


Software  Performance 
Engineering  (SPE) 


Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


Boeing  Military 
Aircraft  Company 
(BMAC) 


ICAM  Project  Contributing  Activities 

1701 ,  2201 ,  Enhancements  for  IBM 

2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC) . 
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Contractors 

I CAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP). 

D.  Appleton  Company 
(DAOOM) 

1502 

IISS  enhancements  to 
Integration  Methodology. 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment. 

Hughes  Aircraft 

Company  (HAC) 

1701 

Test  Bed  enhancements. 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502,  1701, 
1703 

IISS  enhancements  to 

User  Interface/Virtual 
Terminal  Interface 
(UI/VTI) . 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 

i 
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SECTION  1 
SCOPE 


1 . 1  Identification 

This  specification  establishes  the  design  of  Function 
PRE9.4,  "Generate  TOTAL  Request  Processor”,  one  of  the  major 
functions  of  the  Configuration  Item  (Cl)  "Precompiler"  to  be 
built  and  formally  accepted  by  the  I CAM  Program  Offioe.  This  Cl 
constitutes  one  of  the  subsystems  of  the  Common  Data  Model 
Processor  (CDMP). 

1 -2  Functional  Summary 

The  purpose  of  this  Computer  Program  Configuration  Item 
(CPCI)  is  to  generate  a  COBOL  program  that  will  satisfy  a 
retrieval  or  update  NDML  subtransaction  against  a  TOTAL 
database .  r> 

1-  *'V  'r 

^>The  following  functions  will  be  performed  by  this  &PCJ-: 


U-,  1 


1.  Generate  the  Data  Division  section  of  the  Request 
Processor . 

a)  Generate  file  description  and  record  layout  if  the 
NDML  request  resulted  in  a  retrieval 
subtransact i on . 

Generate  the  Working  Storage  section  of  the  Request 
Processor.  These  working  storage  variables  will  be 
used  for: 


a) 

b) 

c) 

d) 

e) 


Conceptual /internal  transformation  of  retrieval 
search  parameters  or  update  values. 

Internal /conceptual  transformation  of  retrieved 
data  fields, 

DBMS  status  checks  and  reserved  words. 

Retrieved  qualification  variables. 

TOTAL  file  descriptions  and  data  field 
descriptions 


Generate  the  Procedure  Division  section  of  the  Request 
Processor.  It  will  include  all  the  code  to  access  a 
particular  TOTAL  database  in  order  to  satisfy  the  NDML 
request.  This  code  will  consist  of: 
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a)  Interfaoe  code  to  the  Request  Processor  Main 
program  at  runtime . 

b)  Code  to  transfora  the  retrieval  search  parameters 
or  update  values  from  conceptual  to  internal 
format . 

c)  Code  using  DBMS  specific  calls  to  access  the 
database  to  retrieve  data  or  update  data. 

d)  Code  to  transform  the  retrieved  data  from  internal 
to  conceptual  format . 

e)  Code  to  save  the  retrieved  data  on  a  sequential 
file. 

f)  Code  to  check  DBMS  status  and  report  errors  during 
runtime  execution. 


1-2 
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SECTIOM  2 
DOCUMENTS 


2. 1  Reference  Documents 

1.  I CAM  Documentat 1  on  Standards :  IDS 150 12000 A ,  28  December 
1961. 

2.  D.  Appleton  Co..  COM  Administrator's  Manual; 

UM620 141 000 .  March  1984. 

3.  D.  Appleton  Co..  CDM1-IDEF,  Model  of  the  Common  Data 
Model;  CCS620 141 000 .  15  May  1985. 

4.  D.  Appleton  Co..  Computer  Program  Deve 1 opment 

Spec i f i cat i on  (PS)  for  I CAM  Integrated  Support  System 
l IISS)  Configuration  Item:  NDML  Precompi ler; 
DS620141200.  October  1984. 

5.  D.  Appleton  Co..  Embedded  NDML  Programmer's  Reference 
Manual;  PRM620141200 .  March  1985. 

6.  Softech.  Inc.,  NTM  Programmer ' s  Guide;  UM620140001, 

July  1984. 

7.  Control  Data  Corp. .  Computer  Development  Specification 
(PS)  for  I CAM  Integrated  Support  System  ( IISS) 

Conf i gurat 1 on  Item :  NDDL  Command  Processor : 

DS620141 100,  June  1985. 

2.2  Terms  and  Abbreviations 

Attribute  Use  Class :  ( AUC ) 

Conceptual  Schema:  (CS) 

Common  Data  Model  Processor:  CCDMP) 

Common  Data  Model :  (CDM)  Describes  common  data  application 
process  formats,  form  definitions,  etc,  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transformation  operators. 


Data  Field:  (DF)  An  element  of  data  in  the  external 
schema.  It  is  by  this  name  that  an  NDML  programmer  references 
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data. 


Database  Management  System:  (DBMS) 

Distributed  Request  Supervisor:  (DRS)  This  IISS  CDM 
subsystem  configuration  item  controls  the  execution  of 
distributed  NDML  queries  and  non  distributed  updates. 

Domain:  A  logical  definition  of  legal  attribute  class 
values . 

Domain  Constraint:  Predicate  that  applies  to  a  single 
domain. 

External  Schema:  (ES) 

Forms:  Structured  views  which  may  be  imposed  on  windows  or 
other  forms.  A  form  is  composed  of  fields  where  each  field  is  a 
form,  item,  or  window. 

Forms  Processor:  (FP)  A  set  of  callable  execution  time 
routines  available  to  an  application  program  for  form 
processing. 

Internal  Schema:  (IS) 

Integrated  Information  Support  System:  (IISS)  A  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  databases  supported  by  heterogeneous  computers 
Interconnected  via  a  local  Area  Network. 

Mapping:  The  correspondence  of  independent  objeots  in  two 
schemas:  ES  to  CS  or  CS  to  IS. 

Network  Transaction  Manager:  (NTM)  Performs  the 
coordination,  communication  and  housekeeping  functions  required 
to  integrate  the  application  processes  and  system  services 
resident  on  the  various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Language:  (NDML)  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
criteria.  It  provides  distributed  retrieved  and  single  node 
updates . 
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ORACLE :  Relational  DBMS  based  on  the  SQL  (Structured  Query 
Language ,  a  product  of  ORACLE  Corp,  Menlo  Park.  CA).  The  CDM  is 
an  ORACLE  database. 

Parcel:  A  sequential  file  containing  section  source  code 
of  the  input  application  prograa. 

Request  Processor:  (RP)  A  COBOL  prograa  that  will  satisfy 
a  retrieval  or  update  VDML  subtransaction  against  a  particular 
Database  Hanageaent  Systea. 

User  Interface:  (01)  Controls  the  user's  terainal  and 
interfaces  with  the  rest  of  the  systea. 

Virtual  Terainal  Interface:  (VTI)  Perforas  the  interfacing 
between  different  terainals  and  the  01.  This  is  done  by 
defining  a  specific  set  of  terainal  features  and  protocols  which 
aust  be  supported  by  01  software  whioh  constitutes  the  Virtual 
Terainal  Definition.  Specific  terainals  are  then  napped  against 
the  Virtual  Terainal  software  by  specific  software  nodules 
written  for  each  type  of  real  terainal  supported. 


2-5 
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SECTION  5 
REQUIREMENTS 


5. 1  gtructural  Description 

A  graphic  portrayal  of  this  CPC I  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationships  of  each 
aodule  Making  up  this  CPCI . 

This  CPCI  uses  a  nuaber  of  lower  level  Modules  to  handle 
specific  operations  such  as: 

1.  Generate  conceptual  scheaa  data  definitions  for 
retrieved  data  fields  (CDRFT). 

2.  Generate  internal  soheaa  data  definitions  for  run tine 
search  paraaeters  (CDPRM) . 

8.  Generate  internal  scheaa  data  definitions  for  retrieved 
data  fields  (CUtDF) . 

4.  Generate  oonoeptual  soheaa  data  definitions  for  runtiae 
search  paraaeters  or  update  values  (CDMSG). 

8.  Generate  Working  Storage  and  Procedure  Division  code 
for  the  conceptual  scheaa  to  internal  scheaa 
transforaation  of  runtiae  search  paraaeters  or  update 
values  (CDCI). 

6.  Generate  Working  Storage  and  Procedure  Division  code 
for  the  internal  scheaa  to  conceptual  scheaa 
transforaation  of  retrieved  data  fields  (CDIC). 

7.  Generate  internal  soheaa  data  definitions  for  qualified 
data  fields  (CDQDF) . 

8.  Combine  two  work  files  into  one  file  containing  the 
Request  Processor  program  (CDCWF). 

9.  Generate  macros  with  the  proper  substitution  paraaeters 
(CDMACR). 

3.2  Functional  Plow 

This  CPCI  implements  the  logic  defined  in  the  Development 
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Specification  for  this  CPCI.  Details  of  inputs/outputs  and 
relationships  between  nodules  are  to  be  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  node.  It  nust  operate  in  the  system  environment 
established  for  IISS;  that  is,  use  of  the  Network  Transaction 
Manager.  It  nust  use  the  ORACLE  Database  Managenent  Systen 
installed  on  a  DEC  VAX  computer. 

3 . 3  Interfaces 


The  following  diagram  depicts  the  interface  of  PRE9.4  with 
other  CPCI ' s  in  the  program 
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3.3.1  Inputs /Outputs 

The  following  table  depicts  the  inputs  and  outputs  of  this 
CPCI.  A  detail  description  for  each  item  can  be  found  in  the  DS 
for  this  CPCI. 

Function:  PRE9.4 

INPUT _ OUTPUT 


Database  Identification  Number 
Database  Name 
Library  Name 
Target  Host 
Current  host 
Request  Processor  Name 
Current  Subtransaction 
Internal  Schema  Action  List 
Internal  Schema  Qualify  List 
Conceptual  Schema  Action  List 
Conceptual  Schema  Qualify  List 
Result  Field  Table 
Set  Table 

Generic  CODASYL  Command  Table 
Record  Key  Table 
Application  Process  Information 
ORACLE  Logon  Data  Area 
Error  File  Name 

3.4  Program  Interrupts 
Not  applicable  to  this  CPCI. 

3.5  Timing  and  Sequencing  Description 

This  CPCI  is  called  upon  by  the  Request  Processor  Control 
Module,  CDP13,  for  every  TOTAL  subtransaction  identified  by  the 
current  NDML  request  being  precompiled. 

3.6  Special  Control  Features 
Not  applicable  to  this  CPCI. 


Source  Code  File  Name 
Function  Status 


Table 
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3.7  Storage  Allocation 

3.7.1  Database  Definition 


The  database  used  by  this  CPC  I  is  the  Common  Data  Model 
CCDM)  database.  This  model  is  defined  by  the  CDM1 .  the  IDEF-1 
model  of  the  CDM ,  Reference  Document  Hustaer  3.  The  database  was 
constructed  using  ORACLE. 

3. 7. 1.1  File  Description 

Mo  permanent  files  have  been  defined  for  this  CPCI.  It  may 
use  temporary  scratch  files  for  the  generated  program  souroe 
code. 

3. 7. 1.2  Table  Description 

All  tables  used  by  this  CPCI  have  been  defined  by  the 
Development  Specification  for  this  CPCI. 

3. 7. 1.3  Item  Description 

Mot  applicable  to  this  CPCI. 

3.8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  test  team  by  using  defined  IISS  Software 
Configuration  Management  procedures.  This  CPCI  will  use  the 
COBOL  language  compiler. 

3.9  Adaptation  Data 

This  CPCI  has  been  coded  using  ANSI  COBOL  and  FORTRAN.  The 
intent  was  to  provide  a  transportable  system.  Any  system 
environment  supporting  these  languages,  a  virtual  memory 
management  scheme,  the  COMM  and  MTM  subsystems  of  IISS  and  the 
ORACLE  Database  Management  System  should  be  able  to  support  this 
CPCI.  Every  possible  attempt  has  been  to  localise  and  identify 
any  machine  or  environment  dependent  modules  through  the 
original  design  of  the  IISS  and  application  of  Configuration 
Management  Procedures. 

3.10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 
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The  following  is  &  list  of  all  "Main  Programs"  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or,  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  oalls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Mote  whether  the  routine 
is  a  Program.  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 
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Module  m 


CDQPT 


GENERATE  TOTAL  RP  Main  Prograu  List 
Purpose 

GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  nodules  being 
documented  here  along  with  their  purpose.  Each  nodule  has  a 
unique  nane,  no  natter  what  language  it  was  written  in. 


J 
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Module 


CDQPT 


GENERATE  TOTAL  RP  Module  List 
Name  Purpose 

GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


PS  620141256 
1  November  1985 


3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 
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GENERATE  TOTAL  RP  External  Routines  List 


Module  Marne 

First  User 

CDCI 

CDQPT 

CDCVF 

CDQPT 

CDIC 

CDQPT 

CDIMD 

CDQPT 

CDMACR 

CDQPT 

CDMSG 

CDQPT 

CDPIC 

CDQPT 

CDPRM 

CDQPT 

CDQDF 

CDQPT 

CDQPOP 

CDQPT 

CDRDF 

CDQPT 

CDRFT 

CDQPT 

ERRPRO 

CDQPT 

GEMFIL 

CDQPT 

OBINDN 

CDQPT 

OCLOSE 

CDQPT 

ODFINM 

CDQPT 

OEXEC 

CDQPT 

OFETCH 

CDQPT 

OOPEN 

CDQPT 

OSQL3 

CDQPT 

RPTERR 

CDQPT 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
include  file. 

A  purpose  of  "*•**  PURPOSE  NOT  FOUND  BY  STRIPPER  ***•" 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  'C'  libraries  that  are 
provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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File  Name 


APGSC 

APINFO 

APRK 

COBOLOP 

CSAL 

CSQUAL 

ERRCDM 

ERRPRO 

INSTTBL 

I  SAL 

ISQUAL 

ORCLEDA 

QPG02 

RFTABLE 

SBSTLST 

SETTAB 

STDRESP 


GENERATE  TOTAL  RP  Include  File  List 

Purpose 


GENERIC  CODASYL  COMMAND  TABLE 

ACCESS  PATH  INFORMATION  TABLE 

TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

WORKING  STORAGE  VARIABLES  OPERATOR  TRANSLATION 

CONCEPTUAL  SCHEMA  ACTION  LIST 

CONCEPTUAL  SCHEMA  QUALIFY  LIST 

IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

PROCESS  ERROR  INCLUDE  FILE 

TABLE  CONTAINING  ALL  GENERIC  CODASYL  COMMANDS 

INTERNAL  SCHEMA  ACTION  LIST 

INTERNAL  SCHEMA  QUALIFY  LIST 

WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

WS  FOR  REQUEST  PROCESSOR  GENERATOR 

THE  RESULT  FIELD  TABLE 

WS  DEFINITION  FOR  THE  SUBSTITUTION  LIST  TABLE 
LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 
WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 
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GENERATE  TOTAL  RP  Where- include-f i le-used  List 

Include  Nodule  Module 

File  Mane  Purpose 


APGC 


CDQPT 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


APINFO 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


APRK 

CDQPT 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


COBOLOP 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CSAL 


CDQPT 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CSQUAL 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 
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GRKRATE  TOTAL  RP  Where- i nc 1 ude-f i le-used  List 

Include  Nodule  Module 

File  Base  Purpose 


ERRCDM 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


ERRPRO 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


INSTTBL 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


I  SAL 


CDQPT 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


I8QUAL 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


ORCLEDA 
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GENERATE  TOTAL  RP  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


QPG02 

CDQPT 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


RFTABLE 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


SBSTLST 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


SETTAB 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


STDRESP 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 
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GENERATE  TOTAL  RP  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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GENERATE  TOTAL  RP  Wbere-external -routine-used  List 

System  Nodule  Module 

Module  Name  Purpose 


CDCI 


CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDCWF 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDIC 


CDQPT 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDIMD 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDMACR 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDMSG 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDPIC 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 
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GENERATE  TOTAL  RP  Where -external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


CDPRM 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDQDF 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDQPOP 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDRDF 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


CDRFT 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


ERRPRO 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


GENFIL 
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GENERATE  TOTAL  RP  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


OBINDN 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


OCLOSE 

CDQPT  GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


ODFINN 


OEXEC 


OFETCH 


OOPEN 


CDQPT 


CDQPT 


CDQPT 


CDQPT 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 


GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 
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GENERATE  TOTAL  RP  Where-external -routine-used  List 


System 

Module 

Module 

Module 

Name 

Purpose 

0SQL3 

CDQPT 

GENERATE 

BASE 

REQUEST  PROCESSOR 

FOR 

TOTAL 

DATA 

RPTERR 

CDQPT 

GENERATE 

BASE 

REQUEST  PROCESSOR 

FOR 

TOTAL 

DATA 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  “well-defined 
module"  appears  by  the  module  name,  if  not  it  is  an  “external 
"routine*.  The  Purpose  of  the  Main  Program  module  is  listed 
as  wel 1 . 
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GENERATE  TOTAL  RP  Main  Program  Parts  List 

Main  Pgn  Module  Module 

Mane  Mane  Type 


CDQPT 


CDCI 

Purpose—  *  GENERATE  REQUEST  PROCESSOR  FOR 
TOTAL  DATA  BASE 

External  routine 

CDCWF 

External 

routine 

CDIC 

External 

routine 

CDIMO 

External 

routine 

CDMACR 

External 

routine 

CDMSG 

External 

routine 

CDPIC 

External 

routine 

CDPRM 

External 

routine 

CDQDF 

External 

routine 

CDQPOP 

External 

routine 

CDRDF 

External 

routine 

CDRFT 

External 

routine 

ERRPRO 

External 

routine 

GEMFIL 

External 

routine 

OBIMDN 

External 

routine 

OCLOSE 

External 

routine 

ODFINM 

External 

routine 

OEXEC 

External 

routine 

OFETCH 

External 

routine 

OOPEN 

External 

routine 

0SQL3 

External 

routine 

RPTERR 

External 

routine 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
following  meanings: 

NAME:  Name  of  program  Module. 

PURPOSE:  Purpose  of  Module  as  detailed  in  the 

source  code. 

LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  CI/S-1  Workbench  C' ) 

VAX- 11  COBOL 

MODULE  TYPE:  Whether  a  Program,  Subroutine,  or 

Function . 

SOURCE  FILE:  Name  of  Source  File  from  file 

specification. 

SOURCE  FILE  TYPE:  Source  File  Extension  from  file 

specification. 

HOST:  Whether  this  is  a  host-dependent 

routine  (VAX  or  IBM)  or  blank  if 
host- independent . 

SUBSYSTEM:  IISS  sub-system  this  file  resides  in. 

SUBDIRECTORY:  Sub-directory  of  that  subsystem  in 

which  this  file  resides. 

DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


DESCRIPTION: 


A  description  of  the  module  as  otained 
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from  the  source  code. 

ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 

INCLUDE  FILES:  A  list  of  all  the  files  that  are 

included  into  this  module  as  well  as 
their  purposes. 

ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by 
this  module,  if  any. 

CALLED  DIRECTLY  BY:  The  documented  routines  which  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM(S):  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 
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GENERATE  TOTAL  RP  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


CDQPT 

GENERATE  REQUEST  PROCESSOR  FOR  TOTAL  DATA 
BASE 

VAX- 11  COBOL 
SUBROUTINE 
CDQPT 
.COB 


SUBSYSTEM:  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41256 


DESCRIPTION: 


-  THIS  PROGRAM  IS  A  COMPILE-TIME  MODULE  WHOSE  PURPOSE 
IS  TO  GENERATE  THE  COBOL  SOURCE  CODE  NECESSARY  TO 
SATISFY  AN  NDML  SUBTRANSACTION  REQUEST  AGAINST  A 
TOTAL  DATABASE.  THE  TOTAL  QP  EXTRACTS  DATA  THROUGH 
LINKPATHS  USING  TOTAL  AS  THE  DBMS  AND  IBM  AS  THE 
HOST  COMPUTER,  AND  THEN  REFORMATS  THE  DATA  INTO 
A  SEQUENTIAL  FILE. 

NOTE:  JANUARY  6,  1985  CHANGES.  ALL  -MOVES"  TO 
LIBRARY-NAME  HAVE  BEEN  REMOVED  AND  THE 
ITEM  WILL  BE  A  PARAMTER  PASSED  FROM  CDP13 
WHEN  THIS  ROUTINE  IS  CALLED. 


ARGUMENTS : 


QPGT-DBID  -  DSPLY  [9(5)] 
QPGT-DBMOD-NAME  -  DSPLY  [X(6)] 
LIBRARY-NAME  -  DSPLY  [X(30)] 
HOST  -  DSPLY  [X(3)] 

MY -HOST  -  DSPLY  [X(3)] 
QPGT-QP-NAME  -  DSPLY  [X(10)l 
QPGT-SUBTRANS-ID  -  DSPLY  [999] 
IS-ACTION-LIST  -  RECRD 
IS -QUALIFY -LI ST  -  RECRD 
CS-ACTION-LIST  -  RECRD 
CS-QUALIFY-LIST  -  RECRD 
RFT  -  RECRD 
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SET-TABLE  -  RECRD 
GC-TABLE  «  RECRD 
RECORD- KEY -TABLE  -  RECRD 
AP-IMFO-TABLE  -  RECRD 
ORACLE-LDA  -  RECRD 
ERRO-FILE  -  D6PLT  [X(30)] 
GEM-FILE-NAME  •  DSPLT  [X(SO)3 
RETURN -STATUS  -  DSPLT  [X(5)l 


IRCLUDE  FILES: 


QPG02  -  VS  FOR  REQUEST  PROCESSOR  GEVERATOR 

ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  NODULES 

IMSTTBL  -  TABLE  COVTAIBIBG  ALL  GENERIC  CODASTL  OOHMAHD6 

SBSTLST  -  VS  DEFIVITIOH  FOR  THE  SUBSTITUTION  LIST  TABLE 

STDRESP  -  VS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

COBOLOP  -  VORKING  STORAGE  VARIABLES  OPERATOR  TRANSLATION 

I SAL  -  INTERNAL  SCHEMA  ACTION  LIST 

ISQUAL  -  INTERNAL  SCHEMA  QUALIFY  LIST 

RFTABLE  -  THE  RESULT  FIELD  TABLE 

CSAL  -  CONCEPTUAL  SCHEMA  ACTION  LIST 

CSQUAL  -  CONCEPTUAL  SCHEMA  QUALIFY  LIST 

SETTAB  -  LIST  OF  SETS  OVNER-HEMBER  RELATIONSHIPS 

APGC  -  GENERIC  CODASYL  COMMAND  TABLE 

APINFO  -  ACCESS  PATH  INFORMATION  TABLE 

APRK  -  TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

ORCLEDA  -  VS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


GENFIL 

OOPEN 

OSQL3 

ODFIHN 

OBINDN 

OEXEC 

OFETCH 

OCLOSE 

CDRFT 

CDPRM 

CDRDF 

CDQDF 

CDPIC 

CDIMD 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  APGC 

PURPOSE:  GENERIC  CODASYL  COMMAND  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


HOLDS  THE  GENERIC  CODASYL  DHL  COMMANDS  FOR  AN 
ACCESS  PATH  OF  A  NDML  REQUEST 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  APINFO 

PURPOSE:  ACCESS  PATH  INFORMATION  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


THIS  IS  A  COLLECTION  OF  INFORMATION  STORED  IN  A 

NUMBER  OF  VARIOUS  TABLES  USED  BY  THE  ACCESS  PATH  TABLE 
AND  THE  GENERIC  GODASYL  TABLE.  SEE  CDMP  SPEC.  PRE6 


APINFO. INC 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  APRK 

PURPOSE:  TABLE  OF  RECORD  KEYS  FOR  OODASYL  ACCESS  PATHS 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  FOR  THE  KEYS  OF 
RECORDS  CONTAINED  IN  THE  CURRENT  ACCESS 
PATH 
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GENERATE  TOTAL  RP  Include  File  Description 
FILE  NAME:  COBOLOP 

PURPOSE:  WORKING  STORAGE  VARIABLES  OPERATOR  TRANSLATION 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 
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GENERATE  TOTAL  RP  Include  File  Description 
FILE  NAME:  CSAL 

PURPOSE:  CONCEPTUAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 

TABLE  TO  HOLD  CONCEPTUAL  DATA  ABOUT  THE  REQUEST 
***••  THE  CONCEPTUAL  SCHEMA  ACTION  LIST 


PS  620141256 
1  November  1985 


GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  CSQUAL 

PURPOSE:  CONCEPTUAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  FOR 
THE  REQUESTS  QUALIFICATION  ' 


THE  CONCEPTUAL  SCHEMA  QUALIFY  LIST 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP 
MODULES  FOR  ERROR  HANDLING 


Ck'-  $>'■  •« 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  INSTTBL 

PURPOSE:  TABLE  CONTAINING  ALL  GENERIC  OODASYL  COMMANDS 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


DECODE  FOR  THE  GENERIC  CODASYL  COMMANDS 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  ISAL 

PURPOSE:  INTERNAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  ABOUT  AN 
NDML  REQUEST 


THE  INTERNAL  SCHEMA  ACTION  LIST 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  ISQUAL 

PURPOSE:  INTERNAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  FOR  AN 
NDML  QULIFICATION 


THE  INTERNAL  SCHEMA  QUALIFY  LIST 
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GENERATE  TOTAL  RP  Include  File  Description 


FILE  MANE:  ORCLEDA 

PURPOSE:  VS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THE  ORACLE  LOGON  DATA  AREA 
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GENERATE  TOTAL  RP  Include  File  Description 


PILE  NAME:  QPG02 

PURPOSE:  VS  FOR  REQUEST  PROCESSOR  GENERATOR 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 
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GENERATE  TOTAL  RP  Include  Pile  Description 


PILE  NAME:  RPTABLE 

PURPOSE:  THE  RESULT  FIELD  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  ABOUT 
THE  RESULTS  OP  AN  NDML  REQUEST 


3-44 


PS  620141256 
1  November  1985 


GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  SBSTLST 

PURPOSE:  WS  DEFINITION  FOR  THE  SUBSTITUTION  LIST  TABLE 

LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION: 


SUBSTITUTION-LIST  REPRESENTS  THE  INPUT  TABLE 
OF  SUBSTITUTION  PARAMETERS  FOR  THE  CDMACR 
MACRO  EXPANSION  SUBROUTINE 


PS  620)41256 
1  November  1955 


GENERATE  TOTAL  RP  Include  File  Description 


FILE  NAME:  SETTAB 

PURPOSE:  LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


SET  TABLE  TO  KEEP  TRACK  OF  CODASYL  NDML  REQUESTS 
IN  TERMS  OF  OWNER  AND  MEMBER  RELATIONSHIPS 
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GENERATE  TOTAL  RP  Include  Pile  Description 


FILE  NAME  STORES P 

PURPOSE:  VS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THE  STANDARD  'PROCESS  COMPLETE'  MESSAGE 
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3.10.10  Hierarchy  Chari 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  nodules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above. 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SKCTIOS  4 

QUALITY  ASSUHASCZ  PhOVISIOSS 


4.1  Introduction  and  Definitions 

‘T«itla|‘  is  a  >Ytt«utlc  process  that  say  bo  preplanned 
end  explicitly  steted.  Test  teduaiques  end  procedures  ney  be 
defined  in  edvence .  end  e  sequence  of  test  steps  ney  be 
specified.  "Debuff inf "  is  the  process  of  isoletion  end 
correction  of  the  oeuse  of  en  error. 

"Antibuff inf ■  is  defined  es  the  philosophy  of  vritinf 
profrens  in  such  e  eey  es  to  neke  bufs  less  likely  to  occur  end 
when  they  do  occur,  to  neke  then  nore  noticeable  to  the 
profrenawr  end  the  user.  In  other  words,  es  nuch  error  checkinf 
es  is  precticel  end  possible  in  eech  routine  should  be 
perf orned . 

4.2  Conputer  Profrennlnf  Test  end  leeleetlon 

The  quelity  essurenoe  prowl sloes  for  test  consists  of  the 
nornel  test inf  techniques  thet  ere  eocoepl i shed  durinf  the 
construction  process.  They  oonsist  of  desifn  end  code 
welk-throufhs .  unit  testinf.  end  intefretion  test inf.  These 
tests  ere  perf orned  by  the  desifn  teen.  Structured  desifn. 
desifn  velk-throufh  end  the  incorporetion  of  "entlbuff inf * 
fecilitete  this  testinf  by  exposinf  end  eddressinf  problen  erees 
before  they  bee one  ooded  "bufs . " 


